package com.app.myApp.dao;

import com.app.myApp.dataobject.KnowledgeBasesDO;
import org.apache.ibatis.annotations.Mapper;
import java.util.List;

/**
 * 个人知识库DAO（操作表knowledge_bases）
 */
@Mapper
public interface KnowledgeBasesDAO {

    /**
     * 新增个人知识库
     * @param knowledgeBasesDO 知识库DO
     * @return 影响行数（1=成功，0=失败）
     */
    int insert(KnowledgeBasesDO knowledgeBasesDO);

    /**
     * 按ID删除个人知识库
     * @param id 知识库ID
     * @return 影响行数
     */
    int deleteById(String id);

    /**
     * 按用户邮箱查询个人知识库列表
     * @param userEmail 用户邮箱（对应表user_email字段）
     * @return 知识库列表
     */
    List<KnowledgeBasesDO> selectByUserEmail(String userEmail);

    /**
     * 按ID查询个人知识库
     * @param id 知识库ID
     * @return 单个知识库DO（无结果则为null）
     */
    KnowledgeBasesDO selectById(String id);

    /**
     * 更新知识库的文件数量（上传/删除文件时用）
     * @param knowledgeBasesDO 需包含id和新的doc_count
     * @return 影响行数
     */
    int updateDocCount(KnowledgeBasesDO knowledgeBasesDO);
}